package com.ylr.user.framework.service;

import com.ylr.user.framework.entity.UserEntity;
import com.ylr.base.common.dto.PageDto;
import com.ylr.user.common.dto.user.UserDto;
import com.ylr.base.common.po.user.UserPo;
import com.ylr.user.common.vo.user.UserFormVo;
import com.ylr.user.common.vo.user.UserVo;
import com.baomidou.mybatisplus.extension.service.IService;
import com.ylr.base.common.dto.NameValue;

import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * Created by IntelliJ IDEA.
 *
 * @author wyw
 * date: 2023-04-21 11:44:08
 * className: UserService
 * version: 1.0
 * description:
 */
public interface UserService extends IService<UserEntity> {

    /**
     * 用户权限校验操作
     * @param userId  用户主键
     * @param module  所属模块
     * @param channel 所属渠道
     * @param uri     接口路径
     * @return 校验结果
     */
    UserPo auth(String userId, String module, String channel, String uri);

    /**
     * 保存用户操作
     * @param userVo 参数对象
     * @return 用户主键
     */
    Long saveUser(UserVo userVo);

    /**
     * 分页查询用户接口
     * @param userFormVo 参数对象
     * @return 用户分页数据
     */
    PageDto<UserDto> pageUserList(UserFormVo userFormVo);

    /**
     * 获取用户操作
     * @param id 用户主键
     * @return 用户数据
     */
    UserDto getUser(Long id);

    /**
     * 批量获取用户操作
     * @param userIdList 用户主键列表
     * @return 用户列表
     */
    List<UserDto> getUserList(List<Long> userIdList);

    /**
     * 获取用户名字映射操作
     * 根据用户主键集合，查询用户名称并进行映射
     * @param userIdSet 用户主键集合
     * @return 用户名字映射
     */
    Map<Long, String> getUsernameMap(Set<Long> userIdSet);

    /**
     * 获取用户名字列表操作
     * @param userIdSet  用户主键集合
     * @return 用户名字列表
     */
    List<NameValue<String>> getUsernameList(Set<Long> userIdSet);

    /**
     * 修改用户操作
     * @param userVo 参数对象
     */
    void updateUser(UserVo userVo);

    /**
     * 重置用户手机号操作
     */
    void resetMobile();

    /**
     * 重置用户邮箱号操作
     */
    void resetEmail();

    /**
     * 删除用户操作
     * @param idList 主键列表
     * @return 成功删除用户个数
     */
    Integer deleteUser(List<Long> idList);

}

